third-party-exp-api
Submit Customer Data IBAN to SSC
URLS:
Description : This mulesoft API will get accountNo from channel which will be sent to T24 to fetch the details. If no data is retrieved from T24 send the error message returned by t24 to channel. If data is retrieved from T24 then send it to SSC to submit the IBAN.
Channels can consume Mulesoft’s REST API exposed as an experience API.
Mulesoft Request:
Mandatory Headers: client_id, x-channel-id, x-correlation-id, x-bank-id, Authorization
Optional Headers: x-user-id, x-sub-channel-id, x-debug-flag, x-customer-id ,client_secret
URI Parameter: NA
Query Params: NA
Body:
{
"accountNo": "4187188"
}
Content-type: application/json
Input to SSC:
FieldName | DataType | Required? | Description |
---|---|---|---|
BankID | Integer | Yes | Unique identifier for the Bank |
Password | String | Yes | Hashed password using Sha2-256 – salt to be provided later |
IsJordanian | Integer | Yes | 1: Jordanian 2: Non-Jordanian 3: Corporate |
NationalID | String | Required if IsJordanian=1 or 3 | 9 or 10-digit number |
PersonalNumber | String | Required if IsJordanian=2 only will be disregarded otherwise | the Personal Number for the individual, or you can send the document number (can be nonnumeric) if personal number is not available |
Name | String | One name field is required | Full name per formal records in Arabic (UTF8 encoding) |
NameEnglish | String | One name field is required | Full name per formal records in English |
IBAN | String | Yes | Alphanumeric |
DOB | Date | Required if IsJordanian=2 only will be disregarded otherwise | DD/MM/YYYY |
Mulesoft Response:
Success Response: (200)
Response Body: application/json
Sample Response
{
"status": {
"success": true,
"code": "200",
"arabicMessage": "تمت العملية بنجاØ",
"englishMessage": "The Operation has been Successfully Completed"
}
}
Sample Error Response:
Error codes :
400:
content-type: JSON
{
"status": {
"success": false,
"code": "400",
"reasonCode": "BadRequest",
"arabicMessage": "",
"englishMessage": "No records were found that matched the selection criteria",
"errorCode": "",
"backendErrorMessage": ""
}
}
Below fields should be given back to Channel if x-debug flag = 1
"errorCode": "",
"backendErrorMessage": "",